Specifies the events to be received by the ModalDialog function.

OSStatus SetModalDialogEventMask (
    DialogPtr inDialog, 
    EventMask inMask
);

inDialog

A pointer to the dialog box for which you wish to set the event mask.

inMask

The desired mask value(s) for the event(s) you wish the dialog box to receive.

function result

A result code.

DISCUSSION

Your application can use the SetModalDialogEventMask function to specify the events received by the ModalDialog function for a given modal dialog box. This allows your application to specify additional events that are not by default received by ModalDialog, such as disk-inserted events and operating-system events. If you use SetModalDialogEventMask to change the ModalDialog function’s event mask, you should pass ModalDialog a pointer to your own event filter function to handle any added events.

Also see the function GetModalDialogEventMask.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when DialogsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by DialogsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)